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112 
113 

114 1.0 INTRODUCTION 

115 

116 

117 The NetNork Interconnect Exerciser (NIE) prov des online diagnostic 

118 exerciser for Ethernet networks. The NIE determines node ability on the 

119 network and provides the operator with error analysis. Node installation, 

120 verification, and problem isolation can be performed using the NIE. 
121 

122 The NIE is device independent. The NIE will run with any Ethernet device 

123 that can be accessed using the DLX interface mechanism. Also, the NIE may 

124 be run on RSX-llM*. IIM and IIS systems. 
125 

126 NOTE: 

127 The DLX (Direct Line Access) interface was designed to 

128 enable user programs to use direct, high-level interface 

129 to a physical line protocol, bypassing the higher level 

130 layers of OECnet. The RSX DEUNA/DELUA QIO Driver uses 

131 this interface to communicate with user programs. 
132 

133 

134 The RSX online NIE nay be used in the following configurations: 

135 

136 Uith OECnet 

137 The NIE runs concurrently with OECnet software. The NIE uses two 

138 NI protocol types: loopback and remote console. The NIE 

139 interfaces to DECnet via the Direct Line Access (DLX) 

140 functionality of DECnet. NIE communicates with the OECnet 

141 Ethernet driver via the NX: pseudo device driver. 
142 

143 Without DECnet 

144 The RSX online NIE can be run using the RSX stand alone DEUNA 

145 driver. This configuration was provided for systems wothout 

146 DECnet. DECnet may be present, however, the Ethernet device to be 

147 used may not be accessed via DECnet. The NIE was developed using 

148 the RSX stand alone DEUNA driver which implements the DLX 

149 interface used by DECnet. 
150 

151 Node table on disk or in memory 

152 The node table may be built on disk into a temporary file. Using 

153 disk, the node«taole may have up to 1024(10) entries. The maximum 

154 size of a memory resident node table is around 70(10) node 

155 entries. 
156 

157 
158 
159 

160 2.0 BUILDING THE NIE 

161 

162 

163 NOTE 

164 OEV:[USER-UIC] refers to device and UIC where the files 

165 were copied to from the distribution kit. 
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2.1 NIE BUILD PARAMETERS 



ri.llNETLIB.MLB 

If the network macro library is not present in account [1,11. the OECnet 
interfaces are not built into the NIE. The absence of this file Mill 
define NONETL-^O in prefix file D.MAC. If NONETL \s defined, the network 
related code will not be included. 



M$$NET 

If not defined in [ll.lOlRSXMC.MAC. the DECnet interfaces are not 
into the NIE. 



built 



R$$11S 

If defined in [11.10]RSXMC.MAC. all code concerned with disk storage 
conditionalized out. 



2.2 PROCEDURE TO BUILD THE NIE 



IS 



NOTE 



The build command file uses the following non-NIE files: 



SY:[11.10]RSXMC.MAC 
M$$NET is in 
R$$11S is in 

SY:[1.1]NETLIB.MLB 

SY:[1.54]RSX11M.STB 



Required RSX macro prefix file!!! 
this file when defined 
this file when defined 

Not required. If not there no DECnet 
interface code will be generated. 
Required to build NIE 



Magnetic media contains the following files: 

CZNIA. SEQ s NIE documentation file 

NIEBLD.CMD 
DEUNA.MLB 



i NIE build command file, used to build 
: the NIE. 

i DLX/Ethernet macros (required for both 
: NIE and XE: Driver 



The following are NIE macro files 



NIESUP.MAC 
NIESU6.MAC 
NIECMD.MAC 
NIEPRS.MAC 



NIE support task code 
NIE task subroutines 
NIc task command processing routines 
NIE command parser modules and data 
structures. 



The following are XE: (DEUNA/DELUA) Driver files. 
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XEDRV.MAC 
XETAB.MAC 
UNAMC.TSK 
LUAMC.TSK 



Building coimnand sequence: 



NOTE 

DEV: for Magtape ' HT: 

OEV: for DL « 0Lx:[3.31 



XE: Driver code 

XE: Driver RSX Database 

XE: Driver DEUNA ECO microcode file 

XE: Driver DELUA ECO microcode file 



>M0U DEV: NIE 
>PIP /NV»0EV : CZNIA. SEQ 
>PIP /NV«DEV: NIEBL0.CMD 
>9NIEBLD 



: Cop 
: Do the build 

Answer questions asked by build command file 



Mount d i str i but i ons k i t 

: Copy documentation file 

y NIE build command file from distro ki' 



*** NOTE **♦ 

See APPENDIX A for sample build print out! 



2.3 INSTALLING NIE 



NIEBLD.Cra) Mill do the installation at the end of the build, 
the system is re-started, the folowing must be installed: 

MCR>INS [USER-UIC]NIE 
MCR>INS [USER-UIClNIl 



However, 



NOTE 



The XE: driver must be installed (LOADED) 
non-DECnet system is being used. 



3.0 RSX QIO UNA DRIVER BUILD 

The follOMing command lines will assemble the driver code and the driver 
RSX database: 

Assemble driver code - 

[ 11,24 Ixedrv, [11,34 ]xedrv/cr/-sp« [1,1 ]exemc/ml,dev: [user-uic]d,- 
deuna/ml . [ 11 . 10 ] rsxmc/pn : 1 , dev : [ user -u i c ] xedrv 

Assemble driver RSX data base - 

[ 11 . 24]xetab . [ 11 . 34 ]xetab/cr/-sp- [1.1 lexemc/ml . - 
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deuna/ffll, [11. 10]rsxmc/pa: l.dev: [user-uic]xetab 



3.1 RSX QIC UNA DRIVER PARAMETERS 

The fol lowing parametes are to be defined in the sv: [11.10 ]RSXMC. MAC file. 
These parameters Nill be defined in the D.MAC prefix file also. The 
values for these parameters in the D.MAC file will be set to the default. 
These parameters will be redefined by their definitions in 
sy:[11.10]RSXMC.MAC. 



NOTE 



Normally, there should be no reason to define/redefine 
these parameters for building the XE Driver! The 
parameters are presented here for documentation 
purposes. 



The following are default definitions: 



U$$NCT»1 
U*$NPC«8. 
U**NRS»8. 
U**NTS=3. 



3.2 BUILDING XE: THE DRIVER 



The DEV:[USER-UIC]NIEBLD.CMD command 
DEV:[ USER 'UIC1XEDRVBL0.CMD command file. This 
to build the XE: driver. 



3.3 INSTALLING (LOADING) THE DRIVER 



RSXllM-PLUS 

MCR>C0N SET VEC^wv CSR=xxxxxx 
MCR>CON ONLINE XEA.XEO: 
MCR>INS UML 



RSXllM 

MCR>LOA XE:/PAR»PARTION 
MCR>INS UML 



Number of controller on system 
Number of ports per controller 
Number of receive ring entries 
Number of transmit ring entries 



file will generate 
file contains the TkB lines 



Set vector and CSR 
Set unit and controller online 
Install DEUNA/OELUA microcode 
. . loader support task 



Load driver 

Install DEUNA/OELUA microcode 
. . loader support task 
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341 
342 

343 4.0 NIE COMMANDS 

344 

345 

346 NOTES 
347 

348 Notation in left and right square brackets is optional. 

349 

350 i.e. - M[ESSAGE] /TY[PE]»ASCII<CR> 

351 

352 is equivalent to 

353 

354 M /TY«ASCII<CR> 

355 

356 Also, spelling errors in optional text are ignored. 

357 

358 i.e. - MEZZAGE /TYTE-ASCII<CR> 

359 

360 Nill be parsed to mean 

361 

362 M /TY»ASCII<CR> 

363 

364 

365 

366 

367 4.1 HELP 

368 

369 

370 A help file showing a summary of NIE commands can be displayed by typing 

371 "Help" or "H" in response to the NIE prompt. For example: 
372 

373 NIE>he[lp] 

374 or 

375 NIE>? 
376 

377 
378 

379 4.2 EXITING THE NIE 

380 

381 

382 The Exit command exits the NIE task. There are no switches or qualifiers 

383 for the Exit command. The format is: 
384 

385 NIE>e[xit] 

386 

387 

388 

389 4.3 BUILDING A NODE TABLE 

390 

391 

392 The current node table is a data structure which the NIE uses to determine 

393 which nodes are available for testing. When the node table is saved on a 

394 disk file, it is saved in ASCII format to allow the node table data to be 

395 examined off line. In addition, the saved node table disk file includes 

396 the logical node names. 
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398 P"9« 9 

399 

400 

401 Data in the node table includes the folloMing: 

402 

403 

404 1. Current node physical address. 

405 

406 

407 2. Default node physical (hardMare; address. 

408 

409 

410 3. NIE assigned logical node address. Node data can be accessed v>a 

411 the NIE assigned logical address. Uhen the node table is saved 

412 in an ASCII text file the logical node addresses are also saved 

413 in ASCII format. 
414 

415 As nodes are added to the node table the NIE assigns logical 

416 addresses in the sequence nl, n2. n3,....etc. In cases where 

417 some nodes have been removed there may be a gap in the logical 

418 addresses. In this case when new nodes are added their logical 

419 addresses are first assigned from the gap. For example, if the 

420 current node table has logical addresses nl. n2. and n5 assigned. 

421 new nodes would be assigned logical addresses n3. n4, n6. 

422 n7...etc. 
423 

424 

425 4. OECNET address. Phase 4 node addresses have the OECnet address 

426 (area. node -number) encoded within the current physical address of 

427 the node. The OECnet address is displayed for phase 4 nodes. 

428 For non-phase 4 nodes "UNKNOUN" is displayed in place of the 

429 OECnet node address. 
430 

431 

432 5. Node device type. (i.e. - OEUNA, OELUA, etc.) In some cases the 

433 node device type may not be known. 
434 

435 
436 
437 

438 4.4 BUILD COMTIANO 

439 

440 

441 The bu'ld command builds the node table by listening to system 10 ffl«>ssages 

442 sent out by each node in 8 minute intervals. 
443 

444 Command format is: 

445 

446 NIE>BU[u;id1 [/m[in1>xxx] 

447 

448 Uhere the switch /HIN is an optional switch to specify the 

449 number of minutes to wait before the build is terminated. 



J 
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453 

454 4.5 SAVING THE CURRENT NODE TABLE 

455 

456 

457 The Save commaf\6 Mill save the contents of the current node table. The 

458 f or«at i s : 
459 

460 NIE>5iCvc] 
461 

462 When a mass storage dcv ce is used the node table is saved in [1.2]NIE.TBL 

463 file. The file then can be printed or viewed using the editor. 
464 

465 NOTE: Uith this version of the NIE you cannot specify a file name to be 

466 used for the save file. The file name i& forced tobe sy:[l,2)NIE.TBL. 
467 

468 When not using a mass storage media, the current node table is copied to a 

469 secondary buffer. The node table then can be modified without distroying 

470 the original node table. 
471 

472 
473 
474 

475 4.6 UNSAVE 

476 

477 

478 The unsave command Mill restore the contents of the node table. If a disk 

479 is used by the NIE, the node table is restored from [1,2]NIE.TBL file. If 

480 no disk is used by the NIE, the secondary buffer is copied over to the 

481 primary buffer, 
482 

483 NOTE: Uith this version of the NIE you cannot specify a file name from 

484 Mhich to do the unsave (restore) from. 

485 The command format Is: 
486 

487 NIE>u[nsave] 

488 

489 

490 

491 4.7 SHOW 

492 

493 

494 The ShoM command Mill print the physical addresses of nodes selected for 

495 testing and the message parameters to be used (either default or operator 

496 input). 
497 

498 The format is: 

499 

500 NIE>shOM < argument > 

501 

502 i.e. - 

503 

504 NIE>sh[ow] n[odes] : Will dispaly the node table 

506 NIE>sh[oM] mCessage] ; Will display message parameters 
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NIE>sh[oM] c[ounters] 

There can be three arguments for Show 

Counters. 



: Uill display counter Information 
They are: Nodes. Messages, 



The ShoM Nodes command lists all nodes in the Node table. The list will 
include the default physical address, the current physical address and a 
logical address assigned to the node by the exerciser. The node can be 
referenced by either of the physical addresses or the logical address. 
Logical addresses will be assigned as nl, n2, n3 etc. 

NOTE: 

The node table display can be stopped with any character 
from the keyboard. 

The ShoM Messages command will list the message type, message size and the 
number of copies to be sent which are currently selected. Also the 
Print/Nopr int status will be displayed indicating the error message output 
mode. 

The ShOM Counters command Mill list the counter contents of the host node. 

EXAMPLES: 

NIE>shoM message 

THE CURRENT MESSAGE PARAMETERS ARE: 
TYPE=ASCII . SIZE-292 . COPIES-1. PRINT 



NIE>shoM nodes 

CURRENT AOR 
AA-OO-04-OO-OA-lO 
AA -00 -04 -00- IB -10 
AA-00-04-00-OB-10 
AA-00-04-00-9C-10 



DEFAULT AOR 
AA-00-03-00-00-01 
AA-00-03-00-00-02 
AA-00-03-00-00-03 
AA-00-03-00-00-04 



NAME 

NO 

Nl 

N2 

N3 



DECNET 

4.10 

4.27 

4.11 

4.156 



DEVICE 

OEUNA 

DELUA 

OECNA 

OEQNA 



NIE>shoH counters 

ETHERNET COUNTER SUMMARY 

SECONDS SINCE LAST ZEROED 

PACKETS RECEIVED 

MULTICAST PACKETS RECEIVED 

PACKETS RECEIVED IN ERROR (BIT MAP) 

DATA BYTES RECEIVED 

MULTICAST BYTES RECEIVED 

RCVS LOST - INTERNAL BUF ERROR 

RCVS LOST - LOCAL BUFFER ERROR 

PACKETS TRANSMITTED 



13257 
91847 
81793 
0 

10491573 

9913460 

46 

0 

12601 
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MULTICAST PACKETS TRANSMITTED 
PKTS XMITTEO WITH 3* COLLISION 
PKTS XMITTEO WITH 2* COLLISION 
PKTS XMITTEO BUT DEFERRED 
BYTES TRANSMITTED 
MULTICAST BYTES TRANSMITTED 
TRANSMIT PACKETS ABORTED (BIT MAP) 
TRANSMIT PACKETS ABORTED COUNTER 
XMIT COLLISION CHECK FAILURE 



4.8 RUN 



2675 

13 

9 

169 

1131157 

406378 

0 

0 

0 



NOTE 

The RUN coamiand performs the specified test on all 
entries of the node table. Tr.<s may cause probleas on 
Extended LANs (multiple LANs cor^nected by Bridges). 
This means that running a test on &I1 nodes in the node 
table may not verify that the LAN in question has been 
properly tested. The node tabic mav not even contain 
all the nodes on the LAN in question. 

Also, on large LANs, running tests agains** all nodes on 
the network may be prohibitive. 

The run command will cause the execution of the test specified by the 
argument. The results of the RUN command are used to update the Summary 
log as well as to output error information. The format is: 

NIE>r[un] <argumcnt>/pass«nm 

The ar g ument for Run can be cither Dtirect]. P[attcrn], L[ooppair] or All. 



The qualifier Pass-nn Mill allow the operator to select the number of 
passes for the particular test selected. If -1 is specified for the 
passcount the test will run continuously. If no passcount is specified, 
the passcount defaults to the passcount set up with the Message command. 

The following are standard NIE data patterns: 

1. ASCII - The ascii data pattern. 

2. ONES - A pattern of all binary I's. 

3. ZEROS - A pattern of all binary O's. 

4. lALT - A pattern of alternating binary I's and O's starting 
with 1 (1010...). 

5. OALT - A pattern of alternating binary O's and I's starting 
with 0 (0101...). 



B2 

CZNIA 



• RSX ONLINE NIE MACRO ni200 10- JUL -85 14:24 PAGE 13 



625 
626 
627 
628 
629 
630 
631 
632 
633 
634 
635 
636 
637 
638 
639 
640 
641 
642 
643 
644 
645 
646 
647 
648 
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664 
665 
666 
667 
668 
669 
670 
671 
672 
673 
674 
675 
676 
677 
678 
679 
680 
681 



Page 13 



6. CCITT - The ccitt data pattern POP 11 assembler format. 



ASCIOATA:: 



i ASCII alphanumer c data pattern 



.ASCII \ !"#U£'()*».-/012345\- 
\6789 : ; < •»^ABCOEFGHIJ\ - 
\KLMNOPQRSTUVUXYZ[ abcd\ - 
\efgh i jklmnopgrstuvMxyN 
\zlTO \ 



CCITTOATA: 

.WORD 
.WORD 
.UORO 
.UORO 
.WORD 
.UORO 



; CCITT 512 bit test pattern 



177603. 157427. 031011. 047321. 163715. 105221 

143325. 142304. 040041. 014116. 052606. 172334 

105025. 123754. 111337. 111523. 030030. 145064 

137642. 143531. 063617. 135075. 066730. 026575 

052012. 053627. 070071. 151172. 165044. 031605 

166632. 016741 



EXAMPLES OF RUN COMMAND OUTPUT: 



NIE>run direct 



DIRECT LOOP TESTING STARTED 



PASS 1 

TESTING NODES 
TESTING NODES 
TESTING NODES 
TESTING NODES 



NIE HOST 
NIE HOST 
NIE HOST TO N3 
NIE HOST TO N4 



TO Nl 
TO N2 



TO NIE HOST -- RESPONSE OK 
TO NIE HOST -- RESPONSE OK 
TO NIE HOST RESPONSE OK 
TO NIE HOST -- RESPONSE OK 



NIE > run looppair 



RUN LOOPPAIR STARTED 



PASS 1 

TESTING NODES 
TESTING NODES 
TESTING NODES 
TESTING NODES 



NIE HOST TO Nl 
NIE HOST TO N2 
NIE HOST TO N3 
NIE HOST TO N4 



TO N2 TO Nl TO NIE HOST - RESPONSE OK 

TO N3 TO N2 TO NIE HOST - - RESPONSE OK 

TO N4 TO N3 TO NIE HOST -- RESPONSE OK 

TO Nl TO N4 TO NIE HOST RESPONSE OK 



NTE>run pattern 
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687 


STARTING ASCII PATTERN TEST 


















688 




























689 


PASS 1 


























690 


TESTING 


NODES 


Nit 


HOST 


TO 


Nl 


TO 


NIE 


HOST 




RE'^PONSE 


OK 




691 


TESTING 


NODES 


NIE 


HOST 


TO 


N2 


TO 


NIE 


HOST 




RESPONSE 


OK 




692 


TESTING 


NODES 


NIE 


HOST 


TO 


N3 


TO 


NIE 


HOST 




RESPONSE 


OK 




693 


TESTING NODES 


NIE 


HOST 


TO 


N4 


TO 


NIE 


HOST 




RESPONSE 


OK 




694 




























695 




























696 


STARTING ONES 


PATTERN TEST 


















697 




























698 


PASS 1 


























699 


TESTING 


NODES 


NIE 


HOST 


TO 


Nl 


TO 


NIE 


HOST 




RESPONSE 


OK 




700 


TESTING NODES 


NIE 


H' ST 


TO 


N2 


TO 


NIE 


HOST 




RESPONSE 


OK 




701 


TESTING 


NODES 


NIF 


jst 


TO 


N3 


TO 


NIE 


HOST 




RESPONSE 


OK 




702 


TESTING NODES 


. Nit 


HOST 


TO 


N4 


TO 


NIE 


HOST 




RESPONSE 


OK 




703 




























704 




























705 


etc 
























706 




























707 




























708 




























709 


NIE > run 


all 
























710 




























711 




























712 


PASS 1 


























713 


TESTING 


NODES 


: NIE 


HOST 


TO 


Nl 


TO 


NIE 


HOST 




RESPONSE 


OK 




714 


TESTING 


NODES 


: NIE 


HOST 


TO 


N2 


TO 


NIE 


HOST 




RESPONSE 


OK 




715 


TESTING 


NOOFS 


NIE 


HOST 


TO 


N3 


TO 


NIE 


HOST 




RESPONSE 


OK 




716 


TESTING 


NODES 


. NIE 


HOST 


TO 


N4 


TO 


NIE 


HOST 




RESPONSE 


OK 




717 




























718 




























719 


RUN ALL 


STARTED 






















720 




























721 


PASS 1 


























722 


TESTING 


NODE Nl WITH REMAINING 


TABLE 


ENTRIES 








723 


TESTING 


NODES 


NIE 


HOST 


TO 


Nl 


TO 


N2 


TO 


NIE 


HOST -- 


RESPONSE 


OK 


724 


TESTING 


NODES 


• NIE 


HOST 


TO 


N2 


TO 


Nl 


TO 


NIE 


HOS^ -- 


RESPONSE 


OK 


725 


TESTING 


NODES 


NIE 


HOST 


TO 


Nl 


TO 


N3 


TO 


NIE 


HOST 


RESPONSE 


OK 


726 


TESTING 


NODES 


NIE 


HOST 


TO 


N3 


TO 


Nl 


TO 


NIE 


HOST -- 


RESPONSE 


OK 


727 


TESTING 


NODt'S 


NIE 


HOST 


TO 


Nl 


TO 


N4 


TO 


NIE 


HOST -- 


RESPONSE 


OK 


728 


TESTING 


NODES 


: NIE 


HOST 


TO 


N4 


TO 


Nl 


TO 


NIE 


HOST 


RESPONSE 


OK 


729 




























730 


PASS 1 


























'31 


TESTING 


NODE N2 WITH REMAINING 


TABLE 


ENTRIES 








732 


TESTING 


NODES 


NIE 


HOST 


TO 


N2 


TO 


N3 


TO 


NIE 


HOST 


RESPONSE 


OK 


/33 


TESTING 


NODES 


NIE 


HOST 


TO 


N3 


TO N2 


TO 


NIE 


HOST 


RESPONSE 


OK 


734 


TESTING 


NODES 


NIE 


HOST 


TO 


N2 


TO 


N4 


TO 


NIE 


HOST 


RESPONSE 


OK 


735 


TESTING 


NODES 


NIE 


HOST 


TO N4 


TO 


N2 


TO 


NIE 


HOST -- 


RESPONSE 


OK 


736 




























737 


PASS 1 


























738 


TESTING 


NODE N3 WITH REMAINING 


TABLE ENTRIES 








739 


TESTING 


NODES: 


NIE 


HOST 


TO 


N3 


TO 


N4 


TO 


NIE 


HOST 


RESPONSE 


OK 
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743 

744 TESTING NODES: NIE HOST TQ N4 TO N3 TO NIE HOST - RESPONSE OK 

745 

746 

747 

748 4.9 BOUNCE 

749 

750 

751 The Bounce coimnand allows the operator to select the path for sending a 

752 packet fro«n the NIE host, through the NI then back to the host. The nodes 

753 identified in the conunand will be sequentially placed into the data field 

754 of the packet with the forward command. The nodes may be specified by 

755 physical or logical addresses. The NIE host node should not be included 

756 in the node list for the Bounce command. The results of the BOUNCE 

757 command have no effect on the Summary log. The format is: 
758 

759 NIE>borunce] addrl,addr2. . . .addrn 

760 

761 The limit on the number of nodes to which the packet can be forwarded is 

762 related to the remaining size of the data field. This command is useful 

763 for testing across repeaters or quickly testing endnodes. 

765 
766 
767 

768 4.10 MESSAGE 

769 

770 

771 The Message command allows the operator to change the defa paramaters 

772 of message type, message size, and message number. The Format is: 

774 NIE>mressage] /tyTpel-asci i/sC ize]=n/c[opies]=n 

776 The message size will be variable, between 46 and 1500 bytes. Message 

777 size is defined as the size of the packet data field and excludes the 

778 source, destination, packet type and CRC fieldb. 
779 

780 The message copies is the number of times the message is to be transmitted 

781 and is a posative integer. A -1 indicates that packets are to be looped 

782 continuously. Default is 1. 
783 

784 
785 
786 

787 4.11 NODES 

788 

789 

790 The Nodes command is used to allow the operator to enter nodes for testing 

791 into the current node table. The format is: 

792 

793 NIE>nodes addrl,addr2 addrn 

794 

795 The addr argument is the physical address of the node on the NI. The NIE 

7% will assign a logical address for each entry in the current node table. 

797 Duplicate nodes may be added in this manner although the NIE assigned 
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600 

801 

602 logical addresses Mill alNays be un'que. 

803 

604 

605 

606 

807 4.12 PRINT /NOPRINT 

606 

609 

610 The PRINT command causes all errors to generate error messages which are 

611 output to the operator. If the NOPRINT command is issued error reporting 

612 stops after the first five errors. In both cases the Summary log h'II 

613 continue to be updated. The PRINT and NOPRINT commands have no arguments 
814 and the default is PRINT. The command stays in effect until! changed by 
615 the operator. The print status is displayed via the SHOU MESSAGE command. 
616 

817 
816 
819 

820 4.13 NOHOE/HOE 

821 

822 

823 i.e. - 

824 

825 NIE>noh[o«J s Oo not halt on error 

626 

627 or 
628 

829 NIE>hoc ; Halt on error (DEFAULT) 

830 

831 Halt on Error (HOE) causes the current RUN to halt Mhen an error is 

832 encountered inspite the pass count. The NO Halt on Error Mill cause the 

833 run to run to completion inspite of errors. 
834 

835 
836 
837 

838 4.14 SUnnARY 

839 

840 

841 The Summary command prints the summary message of conditions and errors as 

842 a result of testing. Summary information is obtained by typing S u mmary 

843 Mhen the NIE is running. There are no sm itches or qualifiers for the 

844 summary command. 
845 

846 NIE>su(mmary] 

847 

848 

849 

850 4.15 CLEAR 



851 
852 
853 
854 

855 The format is: 



The Clear command Mill have three arguments, node, message and summary. 
The format is: 
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857 17 

858 

859 

860 

861 NIE>c[Iear] < argument) 

862 

863 The Clear Node/Addr Mill reitove a node from the node table. The node may 

864 be specified by either its physical or logical address. OPTIONALLY some 

865 implementations may allow a I'st of physical and logical addresses to be 

866 specified. 
867 

868 The "C[lear] N[odc]/A[ll]" will clear the entire node table. 

869 

870 The "Cdear] Mfessagel" will reset the message parameters to the default 

871 state. 
872 

873 The "C[lear1 Su[mmary]" command will clear the node summary table. 

874 

875 

876 

877 

878 4.16 IDENTIFY 

879 

880 

881 The Identify command will perform a request 10 to the physical or logical 

882 address included in the command line. The resulting data Mill then be 

883 displayed. 
884 

885 The format is: 

886 

887 NlE>;[dentify] <address> 

888 

889 EXAMPLE: 
890 

891 NIE> identify 00 -04 -00 -00 -00 -be 

892 

893 NODE CURRENT ADDRESS: 00-04 -00-00-00-BC 

894 NODE DEFAULT ADDRESS: 00-00-AB-OO-OO-OC 

895 RECEIPT NUMBER: A045 
8% MAINTENANCE VERSION: 03 

897 ECO: 00 

898 USER ECO: 00 

899 FUNCTION VALUE 1- OS 

900 FUNCTION VALUE ?. 00 

901 DEVICE: 01 
902 

903 OR. usi-ig a logical node name - 

904 

905 NIE> identify NS 

906 

907 NODE CURRENT ADDRESS: 00-04-00-00-00-BC 

908 NODE DEFAULT ADDRESS: 00-00-AB-OO-OO-OC 

909 RECEIPT NUMBER: A045 

910 MAINTENANCE VERSION: 03 

911 ECO: 00 

912 USER ECO: 00 

913 FUNCTION VALUE 1: 05 
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915 
916 
917 
918 
919 
920 
921 
922 
923 
924 
925 
926 
927 
928 
929 
930 
931 
932 
933 
934 
935 
936 
937 
938 
939 
940 
941 
942 
943 
944 
945 
946 
947 
948 
949 
950 
951 
952 
955 
954 
955 
956 
957 
958 
959 
960 
%l 
%2 
963 
964 
%5 
%6 
%7 
%8 
969 
970 
971 



Page 18 



FUNCTION VALUE 2: 
DEVICE: 01 



4,17 SUMMARY 



00 



A I09 of events is maintained during RUN command processing. These 
statistics caN be displayed with the SUMMARY command. 



NIE>su[mfflacy] 
NODE 

00-04-00-00-00-10 
00-04-00-00-00-11 
00-04-00-00-00-12 
00-04-00-00-00-13 



RCV NOT RCV LENGTH 
COMPLETED COMPLETED ERRORS 
0 10 1 

0 10 1 

0 10 1 

0 10 1 



COMPARE BYTES NUMBER BYTES 
ERRORS COMPARED TRANSFERED 
2000 2000 
2000 2000 
2000 2000 
2000 2000 



5.0 ERROR MESSAGES 



COMMAND OR SWITCH NOT IMPLEMENTED 

Command or switch is an optional NIE function, 
implementation does not support the command. 



HoMever. this 



COMPARE ERROR - BYTE EXPECTED - XXX. BYTE RECEIVED - YYY 

This error is displayed when the data sent in a loop message 
match the data received in the response message. 

INVALID COMHAND 

Invalid or syntactically incorrect command given. 

INVALID COUNTER DATA 

SHOW COUNTERS error message Mhen running under DECnet. 
the counter data received from DECnet is incorrect, 
error. 



docs not 



The format of 
Internal program 



INVALID DISK NAME 

The has tried to accessed the specified disk. The disk docs not exist 

on the current system. Enter correct device name. 
INVALID ETHERNET DEVICE NAME 

NX: and XE: are the only Ethernet devices possible Mith this version 

of the NIE. NX: requires DECnet present and running. XE: device uses 

the stand alone RSX QIO DEUNA/DELUA Driver. You must use one of these 

Ethernet devices. 
INVALID HEX CHARACTER 

Character specified is not a Hex digit. 

INVALID MESSAGE SIZE 
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974 

975 

976 ftaximun Message size on a non OECnet system is 1496(10). naxi«uai 

977 Message size on a OECXnet system is the same as that used by OECnet. 
978 

979 INVALID r^SSAGE TYPE 

980 Message type specified is not valid. 
981 

982 INVALID NODE ADDRESS 

983 Node address as specified is invalid. Node address specified must be a 

984 hex strino or a loa'cal node number. 

905 i.e. - Aa-OO-OO-OO- 00-02 or Nxxx (where. Nxxx is logical node number 

986 assigned by NIE) 

987 

988 INVALID OPTION 

989 Option specified is invalid. 
990 

991 INVALID PASS NUMBER 

992 The pass switch specified with one of the RUN command is invalid. Max 

993 pass is 100. 
994 

995 INVALID PROGRAM PARAMETER - NOT ENOUGH BUFFERS 

996 The number of receive buffers is a hard wired program parameter. This 

997 message is given if this parameter is incorrect. 
998 

999 INVALID PROGRAM PARAMETER - INVALID BUFFER SIZE 

1000 If no mass storage media is being used, the minimum buffer size is 514. 

1001 bytes (disk buffer size plus link word). Physical buffer size is hard 

1002 wired into the program. This should not normally be seen. 
1003 

1004 NIE EXITING 

1005 Just what it says. 
1006 

1007 ???? NODE ENTRIES ADDED TO NODE TABLE 

1008 UNSAVE indicates the number of node entries added to the node table. 
1009 

1010 NODE NOT FOUND 

1011 Node number specified (logical or hex) was not found in the node table. 

1012 The command requires a node address which is in the node table. 
1013 

1014 NODE TABLE EMPTY 

1015 A command was given that requires that the Node Table be not empty. No 

1016 further action is taken. 
1017 

1018 NODE TABLE FULL 

1019 Indicates the NIE was unable to add an entry to the node table, i.e. 

1020 BUILD. UNSAVE. or adding new entries to the node table (NODE...). 
1021 

1022 NO NODES SPECIFIED 

1023 Command requires a node address to be specified. (i.e. CLEAR 

1024 NODE/ "node") 
1025 

1026 NUMBER OF COPIES INVALID 

1027 Number of copies specified is not valid. Currently Max o' copies is 

1028 set at 10.000. 
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1050 
1031 
1032 
1033 
1034 
1035 
1036 
1037 
1038 
1039 
1040 
1041 
1042 
1043 
1044 
1045 
1046 
1047 
1048 
1049 
1050 
1051 
1052 
1053 
1054 
1055 
1056 
1057 
1058 
1059 
1060 
1061 
1062 
1063 
1064 
1065 
1066 
1067 
1068 
1069 
1070 
1071 
1072 
1073 
1074 
1075 
1076 
1077 
1078 
1079 
1080 
1081 
1082 
1083 
1084 
1085 
1086 
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NOT ENOUGH NODES IN NODE TABLE FOR "LOOPPAIR" OR 'RUN ALL" COMMANOS 

There must be at least 2 node entries in the nodetable to RUN LOOPPAIR 
or RUN ALL commands. 

NOT ENOUGH RECEIVE BUFFERS AVAILABLE 

Internal program error. The NIE has lost track of it's recieve buffers. 

OPEN ERROR ON NIE SAVE FILE 

The user attempted to do A SAVE command but NIE Mas unable to 
save file. 



create a 



RESPONSE OK 

This message indicates that the response expected by the NIE was 
recieved by the NIE and that the test data returned was verified to be 
correct . 



PROGRAM ERROR - NO BUFFERS AVAILABLE 

This message should not be seen during normal operation. The NIE 
some internal buffer management for send, and receive messages. 



buffer manager is out of buffers and the NIE 
requested operation. 



is unable to continue 



does 
The 
the 



READ COUNTERS REQUEST TO OECNET FAILED 
Read counters request to DECnet failed. 
SHOU COUNTERS request. 



This is an internal error for 



RECEIVE OECNET COUNTERS FAILED 
Receiving DECnet counters failed. 
COUNTERS request. 



This is an internal error for SHOU 



SET CHARACTERISTICS FAILED 

This message indicates that the set characteristics QIO has been 
rejected. This would occure if two NIEs were to run on the same system 
ana each would try to select the same protocol /address pairs. 



If only one NIE is being run, then this error 
error. 



is an internal program 



TEXT NOT DEFINED - COMMAND IGNORED 

MESSAGE /TYPE'TEXT Mas given before defining the text. Do a MESSAGE 
/TEXT»xyz (xyz is a string of ascii characters) to define the text 
string before issuing MESSAGE /TYPE«TEXT command. 

TIME OUT - REMOTE NODE NOT RESPONDING 

This message is displayed Mhen the NIE wait time expires 
for a response from a remote node. All the conectivi 
result in this message if the remote node being tested 
responding. 



Mhile Maitina 
All the conectivity commands Mill 

Is not 



During a RUN command execution, this message indicates that the 
being tested are displayed in the message on the previous line. 



node(s) 



TRANSMIT ERROR - COMMAND TERMINATED 

This error message only indicates that there has been an error when 



the 
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1089 

1090 

1091 NIE has attempted to transmit a message. It does not indicate Mhat the 

1092 error mas. Transmission errors are caused by sot** hardware 

1093 malfunctioning. Uhen running under DECnet an error log message on the 

1094 console may indicate what the error was. 
1095 

1096 UNABLE TO OBTAIN LOCAL ADDRESS FROM ETHERNET DEVICE DRIVER 

1097 This message may be received in a non-DECnet evironment only. At 

1098 initialize time NIE tries to read the current physical address of the 

1099 Ethernet device. This is needed for source address determination. The 

1100 source address is used in MOP messages to specifiy return address of 

1101 responses, this is a driver /system error. Should not normally occi:re! 
1102 

1103 UNABLE TO OPEN ETHERNET PORT 

1104 This message indicates that the RSX QIO Driver is not present or that 

1105 (if running with DECnet) DECnet is not up and runnina. The error may 

1106 also indicate that the Ethernet device cannot be initialized. 
1107 

1108 UNABLE TO OPEN SAVED NODE TABLE FILE 

1109 UNSAVE command is unable to open saved node table file. 
1110 

1111 UNABLE TO READ COUNTERS FROM DEVICE 

1112 NIE was unable to read counters from non-DECnet driver. This is an 

1113 internal program error. 
1114 

1115 UNABLE TO READ SAVED NODE TABLE FILE 

1116 UNSAVE coflMnand is unable to read saved node table file. 

1117 

1118 UNABLE TO READ UORK FILE 

1119 If the user specified a disk to be used at initialize time. NIE mIII 

1120 create a temporary Cwork file) file on that disk for it's node table. 

1121 An error while trying to read this disk will produce the above message. 

1122 

1123 UNABLE TO TALK TO DECNET 

1124 This message can occure while doing a SHOU COUNTERS command when running 

1125 under DECnet. The NIE is trying to create a Network Data Queue and 

1126 failes. This may be caused by system resources not available or DECnet 

1127 is going down. 
1128 

1129 
1130 

1131 6.0 COUNTERS INTERPRETATION 

1132 

1133 

1134 DELUA/OEUNA Counter Specification: 
1135 

1136 The counter values are unsigned integers. Counters latch at their maximum 

1137 values to indicate overflow. 
1138 

1139 Seconds Since Last Zeroed - 

1140 16 bits for the number of seconds since the counters were last zeroed. 
1141 

1142 Packets Received - 

1143 32 bits for the total number of datagrams received error free. 
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46 



1147 

1148 Multicast Packets Received - 

1149 32 bits for the total number of cmulticast datagrams received error 

1150 free. 
1151 

1152 Packets Received with Error - Bitmap - 

1153 1. Bit <00> - CRC. Block Check Error - A datagram failed the CRC 

1154 check, 
1155 

1156 2. Bit <01> - FRAM. Framing Error - A dataoram failed the CRC 

1157 check and did not contain an integral multiple of 8 bits. 
1158 

1159 3. Bit <02> - MLEN. Message Length Error - A datagram was larger 

1160 than 1518 bytes. 
1161 

1162 4. Bits <15:03> - 0. 

1163 

1164 

1165 Packets Received with Error - 

1166 16 bits for the total number of datagrams received with one or more 

1167 errors logged in the bitmap. Includes only datagrams that passed 

1168 destination address comparison. 
1169 

1170 Data Bytes Received - 

1171 32 bits for the total number of data bytes received error free. 

1172 exclusive of data link protocol overhead. 
1173 

1174 Multicast Bytes Received - 

1175 32 bits for the total number of multicast data bytes received error 

1176 free, exclusive of data link protocol overhead. 

1177 

1178 Receive Packet Lost - 

1179 Internal Buffer Error - 16 bits for the total number of times there was 

1180 a discard of an incoming packet due to lack of internal buffer space. 

1181 Incoaing packets must be error free to be counted. 
1182 

1183 Receive Packet Lost • 

1184 Local Buffer Error - 16 bits for the total number of times there was a 

1185 problem with a receive ring data buffer. This counter is incremented on 

1186 one of more of the following occurences. 
1187 

1188 1. Buffer Unavailable - A datagram was lost because there was no 

1189 available buffer on the receive ring. 
1190 

1191 2. Buffer too Small - A datagram was truncated because it was 

1192 larger than the available buffer space on the receive ring. 
1193 

1194 Packets Transmitted - 32 bits for the total number of datagrams 

1195 successfully transmitted, including transmissions in which the collision 

1196 test signal failed to assert. 
1197 

1198 Multicast Packets Transmitted - 

1199 32 bits for the total number of multicast datagrams successfully 

1200 transmitted, including transmissions in which the collis'on test signal 

1201 failed to assert. 
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1203 
1204 
1205 
1206 
1207 
1208 
1209 
1210 
1211 
1212 
1213 
1214 
1215 
1216 
1217 
1218 
1219 
1220 
1221 
1222 
1223 
1224 
1225 
1326 
1227 
1228 
1229 
1230 
1231 
1232 
1233 
1234 
1235 
1236 
1237 
1238 
1239 
1240 
1241 
1242 
1243 
1244 
124S 
1246 
1247 
1248 
1249 
1250 
1251 
1252 
1253 
1254 
1255 
1256 
1257 
1258 
1259 
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Packets Transmitted - 

3* Attempts - 32 bits for the total number of datagrams successfully 
transmitted on three or more attempts, including transmissions in Mhicn 
the collision test signal failed to assert. 



Packets Transmitted - 

2 Attempts - 32 bits for the total number of datagrams 
transmitted on two attempts, including transmissions 
collision test signal failed to assert. 



successfully 
in Mhich the 



Packets Transmitted - 

Deferred - 32 bits for the total number of datagrams successfully 
transmitted on the first attempt after deferring, including 
transmissions in which the collision test signal failed to assert 

Data Bytes Transmitted - 

32 bits for the total number of data bytes successfully transmitted, 
exclusive of data link protocol overhead ai'd not counting data link 
generated retransmissions, but including trar'r^issions in which the 
collision test signal failed to assert. 

Multicast Bytes Transmitted - 

32 bits for the total number of multicast data bytes successfully 
transmitted, exclusive of data link protocol overhead and not counting 
DELUA generated retransmissions, but including transmissions in which 
the collision test signal failed to assert. 

Transmit Packets Aborted - Bitmap - 



Bit <00> - RTRY. Excessive Collisions 
unsuccessful transmission attempts. 



Retry error, 16 



2. 



4. 
5. 



Bit <01> - LCAR. Loss of Carrier • Retry error (16 
unsuccessful transmission attempts), loss of carrier flag, and 
non-zero TDR value on last attempt. 

Bit <02> • 0. 

Bit <03> - 0. 

Bit <04> - riLEN. Data Block too Long - The DELUA aborted the 
transmission process because the datagram exceeded the maximum 
packet size. 



Bit <05> - LCOL. Remote Failure to defer - Late collision 
the last transmission attempt. 



on 



7. Bits <1S:06> - 0. 

Transmit Packets Aborted - 

16 bits for the total number of datagrams that were 
transmission for one or more of the bitmapped errors. 

Transmit Collision Detect Failure - 



aborted during 
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1261 
1262 
1263 
1264 
1265 
1266 
1267 
1268 
1269 
1270 
1271 
1272 
1275 
1274 
1275 
1276 
1277 
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16 bits for the total number of times the collision test sifioai 
to assert folloiting an apparently suscessful transmission. 



failed 



DELUA ONLY COUNTERS 

PORT DRIVER ERROR - 

16 bits for the total number of times the Port Driver 
issue another Port/Ancilliary command while one is 
processed. 



attempts to 
still being 



BABBLE COUNTER - 

16 bits counter for the total number 
babble condition on the channel. 



of times the LANCE reported the 
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APPENDIX A 
SAMPLE NIE BUILD OUTPUT 



MOU MT0:NIE/DENS-1600 

PIP /NV-MTO: CZNIA. SEQ 

PRINT CZNIA. SEQ 

PIP /NV'MTO: NIEBLO.CMD 

aNIEBLO 



: Mount mag tap« kit 
: Copy docuMcntation file to you area 
; Print doc file for your information 
: Copy NIE build f!l« to your area 



IMIIMIIIIIIIIIIIIIIflMllllllllllllllllllllllllllllilllltlllllllllilil 

•NOtE: i 
! This coMiand file nust be run fron a privileged account as it needs ! 
! to copy some files to the SY:[l.ll area. ! 
!!!!!!!!:!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!! 

The foraat for the input device and UIC is 0EV:[XXX.YYY1. The coMand 
file docs not do extensive syntcx checking. Therefore, if specified, the 
foraat of the device -UIC string iiust be correct. 

Input device and UIC of source files [D«DR0:[6.6]1 [Si: at: 

The forMt for the destination device and UIC is 0EV:[XXX.YYY]. The coMMnd 
file does not do extensive syntex checking. Therefore, if specified, the 
foriMt of the device 'UIC string nust be correct. 



* Output device and destination UIC [DxDROKd.d]] 



PIP ORO: 



PIP ORO: ;6.6 



PIP DRO: 
PIP DRO 



6.6 



6.6 
6.6 



/NV-MT:NIESUP.MAC 
/NV-MT:NIESUe.MAC 
/NV-MT:NIECMD.MAC 
/NV»MT:NIEPRS.HAC 
PIP SY:[l,ll/NV-riT:OEUNA.MLB 
PIP /NV-MT:DEUNA.HLB 
INS (MAC 
INS ITKB 
INS ICRF 

MAC a0R0:r6.6lNIEASM 
TKB 8DR0:[6.6]NIETKB.CM0 
REM NIE 
REM Nil 

INS DR0:[6.61NIE 
INS DR0:[6.6]NI1 



[S): <cr> 
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* Do you Mant to build the OEUNA/DELUA driver? 
PIP SY:[1.1]/NV»MT0:UNAMC.TSK 
DRO : [ 6 . 6 ] /NV-MTO : UNAMC . TSK 
SY:[1.11/NV«MT0:LUAMC.TSK 



PIP 
PIP 
PIP 
PIP 
PIP 
PIP 
MAC 
TKB 



DRO : [ 6 . 6 ] /NV 'MTO : LUAMC . TSK 
DRO: !6. 6 /NV-MTO :XtDRV. MAC 
DRO: '6.6; /NV»MTO:XETAB.MAC 
DR0:[6.6J/NV-MT0:UML.MAC 
aORO: [6.61XEDRVASM.CMD 
90R0: [6.6JXEDRVBLD.CMD 



Ue have completed building the driver and the ECO microcode loader 
support task. 

*** NOTE *** 

If DECnet is running and is using your DEUNA or DELUA device then you 
must not try to LOAD the XE: (DEONA/DELUA) driver as the device Vector 
and RSX Device Control Block are already taken and this Mill cause an 
error. 

However , if DECnet is not running and you wish to use the the RSX QIC 
DEUNA/DELOA driver (XE: Driver) then you can have this command file 
load it for you. at this time. 

* Do you want to LOAD the XE: (DEUNA/DELUA) driver? Y 
REM UML . . . 

: RSX-llM 

>LOAD XE:/PAR>GEN/HIGH 
>INS DR0:[6.6lUnL 

; RSX-llM-PLUS 

>INS $CON 

>LOAD XE:/PAR«GeN/HIGH 

>CON SET XEA VEC«120 CSR-174510 

>CON ONLINE XEA.XEO: 

>INS 0R0:[6,6]UnL 



>a <EOF> 
t 



000001 



.END 
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SYMBOL TABLE 

I 

. ABS. 000000 000 
000000 001 
ERRORS DETECTED: 0 

VIRTUAL MEMORY USED: 29 UORDS ( 1 PAGES) 
DYNAMIC MEMORY: 20324 WORDS ( 78 PAGES) 
ELAPSED TIME: 00:00:17 
. CZNIA. SEQ/-SP-CZHIA 
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